home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / cnet / FPOFL11.lha / FPOFL.Doc < prev    next >
Text File  |  1994-09-11  |  11KB  |  278 lines
  1.  
  2.                         FPOFL version 1.1 release 1
  3.                  The Flux Point Online Filelist Generator
  4.  
  5.                             Copyright © 1994 by
  6.                               Peter M. Klein
  7.                             All Rights Reserved
  8.  
  9.  
  10.  
  11.  * IMPORTANT - Read This (PLEASE):
  12.  
  13.   FPOFL is copyright, so you can't go ahead and just use it however you want,
  14.   there are some restrictions.
  15.  
  16.                                  KeyWare?
  17.                                 ==========
  18.  
  19.   FPOFL is released as KEYWARE, meaning that if YOU, as a CNET Sysop use the
  20.   FPOFL for more that 14 days, AND you have written any PFILES/Utils/Online-
  21.   Games for CNET, that requires registration and/or keyfile. Then you must 
  22.   provide ME with a FULL registered version/keyfile of your program.
  23.  
  24.  
  25.                    Peter Klein
  26.                    Visbygade 4 3tv.
  27.                    2100 Copenhagen Ø
  28.                    Denmark
  29.  
  30.  
  31.  
  32.  * Copyright:
  33.  
  34.   FPOFL is NOT is the PUBLIC DOMAIN.  You can however freely distribute
  35.   it as long as the following is observed:
  36.  
  37.   - The program and documentation must be distributed together
  38.     and may not be modified in any way.  The only exception is that the
  39.     program and documentation may be compressed into an archive for
  40.     uploading to Bulletin Boards or for other electronic transmission.
  41.  
  42.   - The program is not to be used commercially or included in a commercial
  43.     package for profit unless written authorisation from me is obtained
  44.     first.  This version of FPOFL may be freely included on public domain
  45.     library disks or compilation disks provided only a small fee is
  46.     charged for the service.
  47.  
  48.   - There is no warranty for the programs, to the extent permitted by
  49.     applicable law.  Except when otherwise stated in writing the copyright
  50.     holders and/or other parties provide the programs "as is" without
  51.     warranty of any kind, either expressed or implied, including, but not
  52.     limited to, the implied warranties of merchantability and fitness for
  53.     a particular purpose.  The entire risk as to the quality and
  54.     performance of the programs is with you.  Should the programs prove
  55.     defective, you assume the cost of all necessary servicing, repair or
  56.     correction.
  57.  
  58.   - In no event unless required by applicable law or agreed to in
  59.     writing will any copyright holder, or any other party who may
  60.     redistribute the programs as permitted above, be liable to you for
  61.     damages, including any general, special, incidental or consequential
  62.     damages arising out of the use or inability to use the programs
  63.     (including but not limited to loss of data or data being rendered
  64.     inaccurate or losses sustained by you or third parties or a failure of
  65.     the programs to operate with any other programs), even if such holder
  66.     or other party has been advised of the possibility of such damages.
  67.  
  68.  
  69.  
  70.  * Before You Do Anything:
  71.   
  72.   READ THE INSTRUCTIONS COMPLETE BEFORE YOU BEGIN INSTALLING/CREATING A
  73.   FPOFL FILELIST. 
  74.      
  75.  
  76.  
  77.  * Requirements:
  78.  
  79.   CNET BBS v3.05c+ (c) Perspective Software.
  80.   MBLISTER V2.2 (c) by Jens 'McBoe' Boenisch.  or,
  81.   TUCFGII 2.5b (Registered version) (c) by Shawn McNeece.
  82.   & AREXX  :^)
  83.  
  84.  
  85.  
  86.  * Introduction:
  87.  
  88.   FPOFL is a frontend for TUCFGII or MBLister. It works in a way, similar to
  89.   CNET'S own Yanktask. It has the ability to create the Filelist in the
  90.   BACKGROUND, leaving the user to do other things while the list is being 
  91.   generated! The user can also log off the board, and call back later!!
  92.   
  93.   ALL BBS data like: System name, compression method, yank path, yank date
  94.   etc. is TAKEN DIRECTLY from CNet!!! No need for extra configs!!
  95.   
  96.   Has 'Visual Editor' config program, Command line arguments and several
  97.   Sysop features!!
  98.  
  99.  
  100.  * Installation:
  101.  
  102.  
  103.   1) Makedir pfiles:FPOFL
  104.  
  105.   2) Copy the FPOFL.rexx and FPOFL2.rexx to the pfiles:FPOFL/ directory.
  106.  
  107.   3) Insert the following line in your BBSMENU, at the end of the
  108.      '2; Available everywhere':
  109.   
  110.         FL   | #0PFiles:FPOFL/FPOFL.Rexx}
  111.  
  112.      Save it, and reload CNET's Text/Menus.
  113.  
  114.   4) Add the following to your CONFIG/EVENTS:
  115.  
  116.        RunARexx pfiles:FPOFL/FPOFL2.rexx M
  117.  
  118.      Set it to run on each day AFTER 24:00 similar to this example:
  119.  
  120.  -----------------------------------------------------------------------------
  121.    Command                                Events
  122.   ____________   ___________________________________________________________ 
  123.  |RunCNetC  | | |RunARexx PFiles:FPOFL/FPOFL2.rexx M                      | |
  124.  |RunARexx  | | |                                                         | |
  125.  |RunDOS    | | |                                                         | |
  126.  |ReadFile  | | |                                                         |#|
  127.  |DOS-CMD   |#| |                                                         |#|
  128.  |ClosePrt  |#| |                                                         |#|
  129.  |Charges#  |#| |                                                         |^|
  130.  |LogonBPS  |^| |                                                         |v|
  131.  |DloadBPS  |v|  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ 
  132.   ¯¯¯¯¯¯¯¯¯¯¯¯        ____________________________________            ______
  133.                 Args |PFiles:FPOFL/FPOFL2.rexx M          |     Time |400   |
  134.                       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯            ¯¯¯¯¯¯
  135.   ______              ____________________________________            ______
  136.  |  NEW |  [port(s)] |1                                   |    Valid |10    |
  137.   ¯¯¯¯¯¯              ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯            ¯¯¯¯¯¯
  138.   ______              ____________________________________            ______
  139.  |  ADD |       Type | @ |Immediate--force system idle    | Interval |0     |
  140.   ¯¯¯¯¯¯              ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯            ¯¯¯¯¯¯
  141.   ______              ________ ___ ___ ___ ___ ___ ___ ___            ______
  142.  |REMOVE|    [mm/]dd |        | X | X | X | X | X | X | X |  Iterate |1     |
  143.   ¯¯¯¯¯¯              ¯¯¯¯¯¯¯¯ SAT SUN MON TUE WED THU FRI            ¯¯¯¯¯¯
  144.                        ____
  145.                       | OK |
  146.                        ¯¯¯¯
  147.  -----------------------------------------------------------------------------
  148.  
  149.  
  150.  * Configuration:
  151.  
  152.   Now you are ready to configure the FPOFL for your system. Start the FPOFL
  153.   program from Cnet, by typing FL. You should now see a menu similar to this
  154.   one:
  155.  
  156.  -----------------------------------------------------------------------------
  157.           _______________________________________________________
  158.           ]   Flux Point Amiga BBS Online Filelist Generator.   [
  159.           ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  160.     FPOFL v1.0 (C) 1994 by PMK.  -  Flux Point Amiga BBS  +45 3526 2527
  161.  
  162.  
  163.      [F]  Full Filelist.
  164.      [D]  <x> Days back.
  165.      [C]  Since Last call.      (08 Jul 1994)
  166.      [L]  Since last Filelist.  (30 Jun 1994)
  167.      [T]  The Top <x> most downloaded files for each area.
  168.      [U]  List of files that YOU have uploaded.
  169.    * [G]  GLOBAL Filelist. (Includes EVERYTHING!!)
  170.    * [A]  Change Access Group. (current=31  flags=4)
  171.    * [H]  Change Active User.  (current=[1] Pmk)
  172.    * [X]  Load FPOFL'S Config Module.
  173.      [P]  Change compression method. (current=.LHA)
  174.      [S]  Change/View FileList settings.
  175.  
  176.      [Q] Quit FPOFL.
  177.  
  178.      Select Option:?  .
  179.  
  180.  -----------------------------------------------------------------------------
  181.  
  182.   Those marked with an '*' to the left of the key, is Local Mode Only Commands
  183.   (Sysop Commands).
  184.  
  185.   Now select the '[X]  Load FPOFL's Config Module.' option, and it will load
  186.   the Config module. An new menu will appear, similar to this one:
  187.  
  188.  -----------------------------------------------------------------------------
  189.                                             ________________________________
  190.                                            |Flux Point VisualDataEditor     |
  191.                                            |Use cursor keys; ENTER to select|
  192.  ___________________                        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  193. |<<Exit             |
  194.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  195.  ___________________
  196. |Filelister program:| PFiles:FPOFL/MBLIST/MBLister
  197. |Filelist Header   :| S:FPOINT.hdr
  198. |Filelist Footer   :|
  199.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  200.  ___________________                ________________________
  201. |Filelister type   :| MBLister     |Include Invitation Only:| No
  202. |Write usage to log:| Yes          |Include Direct/CDROM   :| No
  203. |Include Private   :| No           |Include Unvalidated    :| No
  204.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  205.  -----------------------------------------------------------------------------
  206.  
  207.   At the 'Filelister program:' prompt, you enter the name/path of the Filelist
  208.   program, that you want to use.
  209.   If you want a header/footer on the filelist, then fill in the name/path of
  210.   your Header/Footer file(s) in the 'Filelist Header:' 'Filelist Footer:'
  211.   input fields.
  212.   Then select the type of Filelister user. Make sure you use the same as you 
  213.   specified in the 'Filelister program:' input field. The rest should speak
  214.   for itself!!
  215.  
  216.    NOTE: The value of the 'Include Direct/CDRom   :' option is not available
  217.          in MBlister, so if you have selected MBlister, then this option will
  218.          be ignored.
  219.  
  220.   Now select the EXIT button, and save the config.
  221.  
  222.   To make a quick test of the setup, type '?' at the prompt. you should then
  223.   se a version list of the various program parts. If this looks OK, then you
  224.   are ready to create your first filelist!!
  225.  
  226.  
  227.  
  228.  * Known Bugs:
  229.  
  230.    When using MBLister, then the '[U] List of files that YOU have uploaded.'
  231.   option generates a top list of ALL areas a user has access to, including
  232.   PRIVATE and UNVALIDATED FILES!!! - MBLister 2nd bug: When using fileflag '0'
  233.   in the UDBASE, makes MBLister create a list of ALL areas, WITHOUT checking
  234.   the access level! SO DO NOT USE FILEFLAG '0' IF YOU ARE USING MBLISTER!!!
  235.  
  236.   Also DO NOT USE FILEFLAG '31' as ARexx can't handle 32bit numbers, so if an
  237.   area has the '31' flag set, the value parsed to the filelister, will be 
  238.   wrong! (It should be possible to manipulate 32bit numbers by using the AREXX
  239.   command NUMERIC DIGITS 10, but it DOESN'T!!!
  240.  
  241.  
  242.  * History:
  243.  
  244.  11 Sep 94 Fixed a bug in the maint module, reported by Spitfire. Also cleaned
  245.            up some bad color codes, and added an extra info to the logfile.
  246.            Now FPOFL also shows the time it took for the user to make the
  247.            Filelist! (Suggested by mUb!)
  248.  09 Jul 94 First Release Version!
  249.  
  250.   
  251.  * Acknowledgements:
  252.  
  253.   I'd like to thank the following people, all of them were a great help in
  254.   betatesting FPOFL:
  255.  
  256.   - Bjarne Christesen
  257.   - Thomas Beck
  258.   - mUb
  259.  
  260.  
  261.   If you wish to contact me, any of the following means are fine:
  262.  
  263.                   BBS: +45 3526 2527
  264.                 CLINK: Pmk @ 912:2000/4.0
  265.                  FIDO: Peter Klein @ 2:235/202.0
  266.          Regular Mail: Peter Klein
  267.                        Visbygade 4 3tv.
  268.                        2100 Copenhagen Ø
  269.                        Denmark
  270.  
  271.   Those are listed in the order in which I will generally be most swift in
  272.   replying.
  273.  
  274.   I thank you for you interest in FPOFL, and I'll be happy to listen to any
  275.   questions of comments you might have.
  276.  
  277.   -PMK
  278.